home *** CD-ROM | disk | FTP | other *** search
/ Windows 6-Pak - Disc 3 / Windows 6-Pak (InfoMagic) (Disc 3) (1999).ISO / MOD-Players-Editors / xmplay14.zip / XMPLAY.TXT < prev   
Text File  |  1999-01-18  |  14KB  |  345 lines
  1. XMPlay 1.4b - Copyright (c) 1998-99 Ian Luck. All rights reserved
  2. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  3.  
  4. Files that you should have found in the XMPlay "package"
  5. ========================================================
  6. XMPLAY.EXE    The executable
  7. XMPLAY.TXT    This file
  8. FILE_ID.DIZ   BBS description file
  9.  
  10.  
  11. What's the point?
  12. =================
  13. XMPlay is an XM/IT/MOD/S3M/MTM player for Windows 9x/NT. It's got the
  14. best (most accurate to FT2) XM reproduction to be heard from any player.
  15. All features/effects (including several FT2 quirks) are 100% supported.
  16. The IT reproduction is also practically balls-on, with full support for
  17. all effects/NNA/DCA/filters etc...
  18.  
  19.  
  20. Main Features
  21. =============
  22. * Balls-on Accurate
  23. - plays XMs the way nature intended.
  24.  
  25. * Sample Interpolation
  26. - linear/spline interpolated sample mixing.
  27.  
  28. * Volume/Pan Ramping
  29. - for output that's smoother than a baby's arse.
  30.  
  31. * 5 Band Equalizer
  32. - adjustable gain at five frequency bands.
  33.  
  34. * Spectrum Analyzer
  35. - something to look at while the music plays.
  36.  
  37. * Surround Sound
  38. - with surround "mode 2", for those mono MODs.
  39.  
  40. * WAV writer "device" (with CODEC support)
  41. - use XMPlay's output to write your own (non-commercial) CD/MP3s.
  42.  
  43. * Track list saving/loading
  44. - with "relative paths/drive" and "keep output" options.
  45.  
  46. * Archive file plugins
  47. - play files from within archives (ZIP/RAR/ARJ/etc...)
  48.  
  49. * Dragon droppings supported :)
  50. - including support for dragging whole directory trees.
  51.  
  52. * Help "bubbles"
  53. - right click on any control for a helpful little bubble.
  54.  
  55. * Nice GUI! :)
  56. - normal/double size, rollovers, customizeable colour scheme.
  57.  
  58.  
  59. The SETUP Window
  60. ================
  61. Device Options
  62. --------------
  63. You can change which device (if you have multiple devices) to use, and
  64. what frequency/resolution/channels/buffer to use with the device. You
  65. may also choose the "XMPlay WAV Writer" device, to write the output to
  66. WAV files rather than a soundcard. Select "XMPlay WAV Writer (codec)" to
  67. write compessed WAVs.
  68.  
  69. The WAVs are saved with the original filename, but with ".WAV" replacing
  70. the original extension. Use the amplification slider to control the volume
  71. of the WAV. Be careful not to use a too high amplification level as this
  72. may result in samples being clipped.
  73.  
  74. TIP: To get the best resolution and avoid clipping, you should switch on
  75.      the AAR (auto amp reduction) option, set the amplification level
  76.      slider to the maximum (far right), and set whatever output options
  77.      you want (EQ/surround/etc...). Then play the whole track through, at
  78.      the end the amp level slider will be at the optimum level. You can
  79.      then play the track again, using the optimum amp level.
  80.  
  81. After you've made changes to the device settings, close the SETUP window
  82. to apply the changes. If the device does not support the settings you
  83. chose, XMPlay will use the closest settings that the device does support.
  84. If you re-open the SETUP window, you will see which settings are actually
  85. being used.
  86.  
  87. GUI Colour Scheme
  88. -----------------
  89. You can change the colour scheme of the GUI. Use the scroller on the right
  90. to select the element you wish to change the colour of and then use the
  91. three colour (red/green/blue) bars. When you have finished making changes,
  92. close the SETUP window to apply the changes.
  93.  
  94. These are the 7 elements you can change the colour of:
  95.         Text (includes the button text/symbols)
  96.         Selected text (includes the button text/symbols)
  97.         Inactive window frame and caption
  98.         Activated window frame and caption
  99.         Button frame
  100.         Selected button frame
  101.         Title text
  102.  
  103. Reset Track List
  104. ----------------
  105. These options decide whether the TRACK LIST should be cleared when adding
  106. new tracks in the various ways.
  107.  
  108. LIST   = Clear the track list when loading a track list (*.XMP file).
  109. DROP   = Clear the track list when drag'n'dropping.
  110. C.LINE = Clear the track list when loading from the command-line.
  111.          This includes loading tracks from Windows Explorer.
  112.  
  113. NOTE: When drag'n'dropping (or loading from the command-line) track list
  114.       files (*.XMP), the DROP (or C.LINE) setting takes precedence over
  115.       the LIST setting. In other words, if DROP (or C.LINE) is off then
  116.       the track list will not be cleared even if LIST is on.
  117.  
  118. Miscellaneous
  119. -------------
  120. A-/LOOP  = Looping switch
  121.            If enabled, the tracks are played over and over until you choose
  122.            to move on to the next track. If there is only one track in the
  123.            TRACK LIST, then it is always looped. You can choose the A-LOOP
  124.            option, to let XMPlay decide if each track is meant to be looped.
  125. HI-LIT   = Rollover controls switch
  126.            Rollovers make the controls (buttons/sliders/etc...) light up as
  127.            the mouse moves over them.
  128. AAR/-R   = Auto amplification reduction switch
  129.            If enabled, the amp level will automatically be reduced whenever
  130.            clipping occurs. You may then have to raise the amp level again
  131.            when you play a new track, unless you select the AAR-R option. The
  132.            AAR-R option will automatically reset the amp level to the centre
  133.            before playing a new track.
  134. TIME     = Time display switch
  135.            Displays the position in time, rather than patterns/divisions.
  136. NORM/FT2/PT1 MOD = Decides how MOD files should be played:
  137.          FT2 MOD = FT2 plays MODs slightly differently from the convention,
  138.            infact most trackers play MODs differently from eachother! Anyway,
  139.            if you want to hear MOD files as FT2 plays them, then select this.
  140.          PT1 MOD = This plays MODs as the original ProTracker did, so now you
  141.            can relive those early Amiga days! :)
  142. BIG      = Big GUI (double size) switch
  143.            For those who use hi-res, where the normal GUI size is too tiny.
  144.            Close the SETUP window to apply the change.
  145. AUTOPLAY = Auto play switch
  146.            Automatically jumps to new tracks, either clicked in the file
  147.            selector, drag'n'dropped, or loaded from Windows Explorer.
  148.  
  149. File Verification
  150. -----------------
  151. FILE SEL = If enabled, the FILE SELECTOR will scan all files, and display
  152.            only the valid ones. Otherwise, files with an XM/MOD/S3M/IT/MTM
  153.            extension (or any archive extension) will be displayed, whether
  154.            they are valid or not. Disabling this obviously increases the
  155.            speed of FILE SELECTOR updates when changing directories.
  156. LIST     = If enabled, all files in track lists (XMP files) will be checked
  157.            before being added to the TRACK LIST. If you have very large track
  158.            lists stored on slow devices (eg. CD-ROM) or inside archives, you
  159.            may want to disable this option to speed up loading track lists.
  160.            When this option is disabled, it also means that the track titles
  161.            will not be scanned leaving the filenames displayed in the TRACK
  162.            LIST window (rather than the track titles).
  163. ARCHIVE  = If enabled, all files in archives are scanned for a valid format.
  164.            Obviously, this can take a while if there are many files to scan
  165.            in an archive. When disabled, only files with an XM/MOD/S3M/IT/MTM
  166.            extension are considered for processing.
  167.  
  168.  
  169. The OUTPUT OPTIONS Window
  170. =========================
  171. LI/SI = Linear/Spline Interpolation switch
  172. R     = Ramping switch (off/normal/sensitive)
  173. S     = Surround Sound switch (off/normal/mode 2)
  174. Eq    = Equalizer switch
  175.  
  176. The graphic equalizer sliders range from +10dB (top) to -10dB (bottom).
  177.  
  178. The slider on the bottom-right is the pan seperation slider. This obviously
  179. can only affect things when playing in stereo.
  180.  
  181. The slider on the bottom-left is the amplification slider, this is different
  182. to the volume slider. The volume slider controls the level of the sound
  183. card output, the amplification slider controls the level of the actual
  184. mixing output. The higher the amplification, the greater the resolution of
  185. the mixing output, but if it's too high clipping may occur resulting in
  186. distortion of the sound.
  187.  
  188. TIP: To centre any of the sliders (EQ/amplification/pan seperation), hold
  189.      either of the SHIFT keys while clicking on the slider.
  190.  
  191. NOTE: The response speed to these options is dependant on the buffer size,
  192.       the delay will be the length of the buffer chosen in the SETUP.
  193.  
  194.  
  195. The TRACK LIST Window
  196. =====================
  197. CLEAR = Clear all tracks from list
  198. SAVE  = Save the current track list
  199.         This will bring up the SAVE TRACK LIST window, in which you can
  200.         enter a filename for the track list. If no extension is supplied,
  201.         ".XMP" will be used. You can also use the following options:
  202.         KEEP OUTPUT = If enabled, the current OUTPUT OPTIONS settings are
  203.                       stored with the track list, to be used as defaults
  204.                       whenever the track list is loaded.
  205.         REL. PATHS  = If enabled, the track filenames are stored relative
  206.                       to the path of the track list file. When disabled,
  207.                       the full paths are stored. If REL. DRIVE is selected
  208.                       then the full paths are stored, except the drive is
  209.                       omitted if it's the same drive as the track list is
  210.                       being saved to.
  211.  
  212.  
  213. The Equalizer
  214. =============
  215. If you don't have your sound card output going through an equalizer (or a
  216. hi-fi with one) then you can use this option to provide one.
  217.  
  218. The equalizer's five centre frequencies are 70hz, 350hz, 1000hz, 3500hz
  219. and 10000hz. By using the equalizer you can emphasise or weaken these
  220. frequencies. For example, you can boost the bass by using a positive gain
  221. at the low frequencies, or you can boost the treble by using a positive
  222. gain at the high frequencies. The gains are meusured in dB, a gain of 10dB
  223. doubles the level of the frequency, a gain of -10dB halves the level, a
  224. gain of 0dB leaves the level as it is.
  225.  
  226.  
  227. The Keyboard Shortcuts
  228. ======================
  229.  P (or Pause) = Pause/Play
  230.          Home = Restart
  231.   left cursor = Rewind
  232.  right cursor = Forward
  233.       Page Up = Previous track
  234.     Page Down = Next track
  235.  (numpad) -,+ = Adjust volume
  236.  (numpad) /,* = Adjust amplification
  237.    Delete,End = Adjust pan seperation
  238.             I = Interpolation switch
  239.             R = Ramping switch
  240.             S = Surround sound switch
  241.             Q = Equalizer switch
  242.             T = Time display switch
  243.      shift+F9 = Display message in INFO 'N' STUFF window (IT/MTM only)
  244.  
  245.  
  246. Archive plugins
  247. ===============
  248. The archive plugins are available at the XMPlay homepage. To activate
  249. a plugin, simply put it in the same directory as XMPLAY.EXE is in.
  250.  
  251.  
  252. Latest Version
  253. ==============
  254. The latest version of XMPlay can always be found at the XMPlay homepage:
  255.  
  256.         http://www.icl.ndirect.co.uk/music/
  257.  
  258.  
  259. Copyright, Disclaimer, and all that other jazz
  260. ==============================================
  261. This program is free for non-commercial use, so if anyone tries to charge
  262. you for it kick 'em where it hurts.
  263.  
  264. This software is provided as-is. The author makes absolutely no warranties
  265. on it. You use it at your own risk. The author shall not be held responsible
  266. for any damage that may result from its use, including, but not limited to,
  267. burning your toast while being too engrossed in the XMPlay "experience".
  268.  
  269. All trademarks and other registered names contained in the XMPlay
  270. "package" are the property of their respective owners.
  271.  
  272.  
  273. History
  274. =======
  275. These are the major (and not so major) changes at each version
  276. stage. There are also many bug fixes made along the way too!
  277.  
  278. 1.4 (a/b)
  279. ---------
  280. * Some little bug fixes - don't you hate it when that happens?! :)
  281.  
  282. 1.4 - 9/1/99
  283. ------------
  284. * MTM playback
  285. * System file selector option
  286. * REL. DRIVE option when saving track lists
  287. * AAR (auto amp reduction) options
  288. * Archive file plugins
  289. * PT1 MOD option - plays the "original" ProTracker MODs
  290. * Audio CODEC support - writes compressed WAVs
  291. * FILE VERIFICATION options
  292. * Directory drag'n'dropping
  293. * A-LOOP (auto loop detection) option
  294.  
  295. 1.3 - 26/10/98
  296. --------------
  297. * IT playback - all FX/NNA/DCA/filters etc...
  298. * "Mini on top" mode - double-click the caption to toggle
  299. * New amplification slider - larger range
  300. * Pan seperation slider
  301. * Help "bubbles"
  302. * MMX accelerated mixing
  303. * INFO 'N' STUFF window replaces INSTRUMENT LIST window
  304.  
  305. 1.2 - 27/9/98
  306. -------------
  307. * S3M playback
  308. * Play position slider
  309. * Surround mode 2 - ignores pan pos, useful for mono MOD/S3Ms
  310. * WAV writer "device"
  311. * AUTOPLAY/ROLLOVERS/TIME/FT2 MOD options
  312. * Amplification slider
  313. * Optimized equalizer
  314. * Track list saving/loading
  315. * RESET TRACK LIST options
  316. * Variable sized INSTRUMENT LIST/TRACK LIST/FILE SELECTOR windows
  317.  
  318. 1.1 - 2/8/98
  319. ------------
  320. * SETUP options window
  321. * Optimized surround sound
  322. * Heavily optimized spline interpolation
  323. * BIG GUI option
  324.  
  325. 1.0 - 15/7/98
  326. -------------
  327. First Release
  328.  
  329.  
  330. The "thank you" section
  331. =======================
  332. BIG thanks go to Isao Kasai, Maz, Yello '73, Neurotix, Mike Toomim,
  333. Progg, Frater Sinister, Kaparo, and especially It-Alien, who between
  334. them have helped find a shitload of bugs for fixing.
  335.  
  336. Also thanks to all who have sent good suggestions and bug reports.
  337.  
  338.  
  339. Bug reports, Suggestions, Comments etc...
  340. =========================================
  341. If you have any of the aforementioned you can email:
  342.  
  343.         xmplay@icl.ndirect.co.uk
  344.  
  345.